home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / pcr / pcr4_4.lha / DIST / loading / README < prev    next >
Text File  |  1989-01-10  |  2KB  |  50 lines

  1. This is the pcr loading component
  2.  
  3. Loading provides the mechanism for dynamically loading executables (a.out format files) into the pcr.
  4.  
  5. To create the loading world, one just has to issue the command 'make' in the 
  6. loading subdirectory othe the DEVELOPMENT tree.  This will cause loading.o to 
  7. be created and this is the component which will be bound into the pcr.  In 
  8. addition to loading.o, the following commands are also created: 
  9. transform_symtab fixcore simplify_symtab delete_symtab and are inserted into the
  10. /BIN subdirectory as commands available by the loading component.  The man entry
  11. for cedarload under pcr should be consulted for an explanation of these
  12. commands.
  13.  
  14. The loading component will keep a record of each "a.out" file that has been loaded, along with the address at which it has been loaded.  This record is kept in a file named /tmp/symtab.pidXXX where XXX is the process ID of the pcr.  This file is later used by "transform_symtab" within "XrDBX" inorder to create an "a.out" file that DBX can read and use for debugging.  
  15.  
  16. There are four regression tests (for now) that are of interest:
  17. testload, testjmp, testsignaltrace, and testsignaljmp.  Testload will create a 
  18. 'loadable' world and to run this regression test, you should first type 
  19. 'make testload', and then run testload and load into it test1, test2, test3 
  20. (in that order -- they will be created with 'make testload').  Then at 
  21. the prompt for testload, type 'call _test3' and the following should be printed:
  22.   Hello wolrd
  23.   inside test3
  24.   Inside test2
  25.   Hello world
  26.   Hello world
  27.   
  28.   '_test3' returns 2b
  29.   
  30. The rest of the regression tests will run themselves when a make to them 
  31. is inferred.
  32.   
  33. Loading has one include file (unwind.h) that is exported to the rest of the pcr
  34. world and used internally in loading.
  35.  
  36. The bottom of the main make file contains a dependency listing of the files
  37. that make up loading.
  38.  
  39. NOTES
  40.  
  41. - Provides dynamic loading of modules into pcr.
  42.  
  43. - Some regression tests missing files or not working (obsolete?).  Look
  44.     in makefile
  45.  
  46. LOG
  47.  
  48. AIshigo, January 10, 1989 10:45:19 am PST
  49.  
  50.